home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Misc / LK_V1.06.LHA / LK V1.06 / HELP / command.hlp < prev    next >
Encoding:
INI File  |  1994-11-01  |  4.5 KB  |  112 lines
  1. [LANGUAGE english; PARENT index; PAGE 6]
  2. [C;6;B]        The command line
  3. [J;1;N]
  4.   Please select one of the following points:
  5. [3]
  6. [GOTO auto]            Automatic WITH File
  7. [GOTO command]            Command Line Contents
  8. [GOTO comment]            Commentaries
  9. [GOTO order]            Instructions Order
  10. [GOTO preferences]        Preferences File
  11.  
  12. [5;LABEL command]  . Command Line Contents
  13. [1]
  14.   A command line is a list of words. A word is a string of any \
  15. character except spaces, tabulations, carriage return and line \
  16. feed; a carriage return is taken as a space character \
  17. and should be followed by a line feed. A special case exist: \
  18. this is the the quoted words, which may contains spaces but \
  19. no line feed.
  20.  
  21.   Keywords are reserved and cannot be used as a file name. The \
  22. pool of reserved keywords is supposed to grow in the future. \
  23. Also you may write the name of your files between quotes to \
  24. avoid any confusion with any upcoming version or release. \
  25. To see all keywords actually available click on next line:
  26. [C;3; LINK keywords]        Keywords list
  27. [J;1]
  28.   A file name or parameter is any word which is not a keyword. \
  29. Any word explicitly written between quotes will never be used \
  30. as a keyword. Available quotes are '...' or "...". Opposite \
  31. cotes can be used inside the other ones. Quotes are useful \
  32. if you need to use specific characters like a space or a sharp \
  33. (#) sign.
  34.   Note that the following command line will be parsed as two \
  35. words:
  36. [C;2]word1"word 2"
  37. [J;1]is also 'word1' and 'word 2'.
  38.  
  39.   All keywords and file names are case insensitive. But the \
  40. parameters may have to be written in upper and/or lower case.
  41.  
  42. [5;LABEL order]  . Instructions Order
  43. [1]
  44.   The order of instructions on your command line is totally \
  45. insignificant, except in one special case. See also:
  46. [C;3; LINK from]    FROM/ROOT keyword
  47. [J;1]
  48.   The order of files might be very significant if you link C \
  49. objects and libraries. The first file contains the startup and \
  50. libraries must usuly be given in a specific order. Please, \
  51. refer to the documentation of you C to know how it works.
  52.  
  53. [5;LABEL comment]  . Commentaries
  54. [1]
  55.   In your WITH files you may include some commentaries. Those \
  56. are like in assembly language; starting  with a semi-colon (;) \
  57. and ending with the end of the line. The commentaries of your \
  58. makefile are also supported; those start with a sharp (#) sign and \
  59. end with the end of the line. Because the diese sign can be used \
  60. for AmigaDOS patterns, it has to be followed by a space or a \
  61. tabulation character to be taken as a commentary entry. A diese \
  62. used alone (followed by a new line) will be taken as the end \
  63. of the overlay section if you are listing overlaid file names; \
  64. otherwise it is taken as a commentary (This is done this way \
  65. to keep the compatibility with Slink.)
  66.  
  67. [5;LABEL preferences]  . Preference File
  68. [1]
  69.   The name of the preference file can be defined through \
  70. 'LK/PREFS' global variable or, when you start lk from \
  71. the Workbench, 'PREFS' tool type (The tool type will \
  72. overwrite the global variable definition.)
  73.   If none of those definition is given, or if files does not \
  74. exist, lk uses the default preference file names (in \
  75. the order it is searched):
  76. [C;I]        lk.prefs
  77.         blinkwith (For Blink compatibility)
  78. [J;N]The preference file is searched and exectuted before \
  79. anything else (even the command line!)
  80. [LABEL withpath]  The preference file will be searched into \
  81. all directories defined with the 'WITHPATH'. The default paths are:
  82.   . Current Directory
  83.     (directory of lk icon from the Workbench)
  84.   . LK:PREFS/
  85.   . S:
  86.   . SLINKWITH:
  87. Paths can be redefined into the variable 'LK/WITHPATH'. Please \
  88. refer to the following instruction for more information:
  89. [C;3][LINK paths]        WITHPATH
  90. [J;1]
  91.   The file which is found by lk can contain all your defaults; \
  92. like SC, SD and SB.
  93.   Note that the preference file can include WITH instructions, \
  94. but those included files will be executed AFTER the command line. \
  95. This can be used to always override some user instructions!
  96.  
  97. [5;LABEL auto]  . Automatic WITH File
  98. [1]
  99.   When lk is used without any arguments, it checks for a \
  100. default WITH file. This file is named 'Automatic WITH File'. \
  101. lk searchs for one file only, its name is one of the following:
  102. [C;I]
  103.     lkfile
  104.     lk.file
  105.     lk.with
  106. [J;N]
  107. lk searchs in this order. The first existing file will be \
  108. used as a WITH file, if other files exists they are ignored. \
  109.   Like said above for the preference WITH file, each file is \
  110. searched into the corresponding list of paths; see also:
  111. [C;3;GOTO withpath]        The With Paths
  112.